home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1995 October / EnigmA AMIGA RUN 01 (1995)(G.R. Edizioni)(IT)[!][issue 1995-10][Aminet 7].iso / Aminet / mus / play / splib43U.lha / superplay-lib_USR / Docs / SPObject-Docs / SPO.doc < prev    next >
Text File  |  1994-12-13  |  4KB  |  135 lines
  1.  
  2.   SPO.svobject
  3.  
  4.   © 1994 by Andreas R. Kleinert.
  5.  
  6.   FREEWARE. All rights reserved.
  7.  
  8.   Version      : 2.2
  9.   Release Date : 21.07.1994
  10.  
  11.  
  12.   Description
  13.   ~~~~~~~~~~~
  14.   SPO.svobject is an external Library-Module for the superplay.library V1+.
  15.  
  16.   It supports reading and writing of SPO Sample-Files.
  17.  
  18.  
  19.   Requirements
  20.   ~~~~~~~~~~~~
  21.   - OS V2.04+ (V37)+ and its libraries
  22.   - xpkmaster.library V2+
  23.  
  24.  
  25.   File Format Information
  26.   ~~~~~~~~~~~~~~~~~~~~~~~
  27.   Sound Samples in the "SPO Sample File Format" consist of two Files :
  28.   The Header-File (<Sample>.spo) and the Data-File (<Sample>).
  29.   The Header-File contains information about the Raw-Data in the
  30.   Data-File. For loading and saving the Sample it makes no difference,
  31.   which FileName - Header-File or Data-File - is given.
  32.   This is managed by the SPObject.
  33.  
  34.   Because recognition of the Types of packed Files is only possible
  35.   by reading the whole File into a buffer and then check it, we use
  36.   two different Files for both : Sample Information and Sample-
  37.   The Data-File CAN be packed, the Header-File MUST NOT be packed.
  38.  
  39.   The SPO.object does NOT save packed data, but it is possible, to pack
  40.   the Data File with ANY XPK-Packer you like, because the SPO.spobject
  41.   uses the xpk.library for decoding.
  42.  
  43.   This allows efficient packing and unpacking with PowerPacker and all
  44.   other XPK-Packers.
  45.  
  46.   Remember, that the original Data written by the SPO.spobject is NOT packed
  47.   and therefore needs a lot of Diskspace. So pack it immediately after it
  48.   has been written.
  49.  
  50.   The Data saved into the <Sample> File is written almost in the same
  51.   way like in an IFF-8SVX. The only difference is : Future versions might
  52.   contain 12- or 16-Bit Sample Data.
  53.  
  54.  
  55.   Source-Code
  56.   ~~~~~~~~~~~
  57.   The "SPO Sample File Format" is an "Open File Format", which means,
  58.   that everyone is invented to use and support it and to make suggestions
  59.   to improve the File Format or the Algorithms to handle it.
  60.  
  61.   To allow support of the File Format and to give an example, how to write
  62.   your own superview.library compatible "spobjects", this distribution
  63.   contains the full SourceCode of the "SPO.spobject".
  64.  
  65.   Feel free to use it for your own, commercial or non-commercial, programs !
  66.  
  67.  
  68.   Author
  69.   ~~~~~~
  70.   Andreas R. Kleinert
  71.   Grube Hohe Grethe 23
  72.   D-57074 Siegen
  73.   Germany
  74.  
  75.  
  76.   Features / Handicaps
  77.   ~~~~~~~~~~~~~~~~~~~~
  78.   - once a sample has been loaded, it will be repeated until an explicite
  79.     stop command arrives
  80.   - an arriving stop command waits (asynchroneous) until the current repeat
  81.     loop ends
  82.   - there's no possibility to continue a once stopped Sample
  83.  
  84.  
  85.   History :
  86.   ~~~~~~~~~
  87.   V2.2 (21.07.1994) :
  88.  
  89.    - added possibility to save all Samples from all multiple-SampleList
  90.      and to accept NULL parameters for the Source-SPObject with
  91.      SPO_Write(), so that custom applications may save their self-
  92.      created SampleLists by simply setting them via SPO_SetSampleList().
  93.      The old way behaviour is still supported (as also handling of
  94.      V1 SPObjects).
  95.    - will correctly write Samples with more Bits than 8,
  96.      if it is confronted with them
  97.  
  98.  
  99.   V2.1 (17.07.1994) :
  100.  
  101.    - integrated new "SampleList"-Functions for exporting more than one
  102.      sample
  103.  
  104.  
  105.   V1.4 (30.04.1994) :
  106.  
  107.    - fixed (hopefully) "header not located" problems within memory
  108.      delocation
  109.  
  110.  
  111.   V1.3 (30.03.1994) :
  112.  
  113.    - replaced SAS/C's sprintf()-routine with own, RawDoFmt()-based one.
  114.      This saves about 1800 Bytes.
  115.    - "utility.library" is not used, because this crashes the Player-Task
  116.      and no reason for this could be found.
  117.  
  118.  
  119.   V1.2 (27.02.1994) :
  120.  
  121.    - fixed small bug in memory management routines
  122.  
  123.  
  124.   V1.1 (16.01.1994) :
  125.  
  126.    - first version
  127.  
  128.  
  129.   Copyrights
  130.   ~~~~~~~~~~
  131.   Some of the mentioned names or products above may be copyrighted by
  132.   companies or trademarks of companies.
  133.  
  134.  
  135.